<h1 create_tag>Create a tag</h1>

<p>Registers tag information.</p>

<pre>[POST] <hl>/api/v1/tags</hl></pre>

<h2 create_tag_request_body>Request body</h2>

<table>
  <tr>
    <th>Field</th>
    <th>Type</th>
    <th>Required</th>
    <th>Range</th>
    <th>Description</th>
  </tr>
  <tr>
    <td><tt>name</tt></td>
    <td><tt>string</tt></td>
    <td><tt>true</tt></td>
    <td><tt>length: [1, 64]</tt></td>
    <td>Tag's name.</td>
  </tr>
</table>

<h2 create_tag_example>Example</h2>

<pre>
curl -X POST \
  --oauth2-bearer AUTH_TOKEN \
  --data-urlencode 'name=php' \
  http://localhost:8080/api/v1/tags
</pre>

<h2 create_tag_response>Response</h2>

<pre>
{
  "data": {
    "id": "84eacd98-43e9-425b-8d36-382ef01715e6",
    "name": "php",
    "user_id": "d4674b90-5ceb-4349-b4c3-ce7cdcd4ffc8",
    "created_at": "2025-03-12 18:59:12",
    "updated_at": "2025-03-12 18:59:12"
  }
}
</pre>
